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Selenium Webdriver 简易 教程 


Selenium 是 ThroughtWorks 公 司 开发 的 一 套 Web 自 动 化 测试 工具 。 
它 分 为 三 个 组 件 : 


e Selenium IDE 
е Selenium КС (Remote Control) 
e Selenium Webdriver 


Selenium IDE 是 firefox 的 一 个 插件 ， 人 允许 测试 人 员 录 制 脚本 并 回放 。 

Selenium RC 和 Selenium Webdriver 是 测试 框架 ， 提 供 多 种 语言 的 APIl。 不 同 的 
是 ，Selenium Webdriver 以 一 种 更 底层 、 更 灵活 的 方式 来 操作 浏览 器 ， 并 不 仅仅 
使 用 javascript。 这 样 它 可 以 绕 开 浏览 器 的 沙 箱 限 制 ， 实 现 Selenium RC 不 支持 的 框 
架 、 弹 出 窗口 、 页 面 导航 、 下 拉 菜 单 、 基 于 AJAX 的 UI 元素 等 控件 的 操作 。 以 

及 ，Selenium Webdriver 不 需要 本 地 服务 器 。 


Selenium 1.x 版 本 只 包含 前 两 个 组 件 。 从 2.0 开 始 Webdriver 加 入 其 中 。 


准备 工作 
由 于 本 篇 教程 用 Java 做 示范 ， 所 以 请 先 安装 JDK 并 配置 好 环境 变量 。 


到 官网 下 载 库 文件 selenium-java-2.xx.x.zip ， 如 果 官 网 被 墙 了 就 到 CSDN 去 
找 。 打 开 压 缩 包 ， selenium-java-2.25.0.jar 的 库 文件 ， 需 要 导入 到 项 目 

中 ; selenium-java-2.25.0-srcs.jar 是 源码 ， 里 面 是 一 些 *java 文 件 ; lib 文 
件 夹 里 面 是 依赖 包 ， 也 要 一 起 导入 到 项 目 中 。 


除了 firefox 浏 览 器 ， 其 它 浏 览 器 基本 都 需要 驱动 ， 同 样 请 到 官网 下 载 。 


- 


打开 默认 路 径 的 firefox 


WebDriver driver = new ҒігеТохбгімег(); 


打开 指定 路 径 的 firefox 


System.serProperty("webdriver. firefox.bin", 
"C:\\Program Files\\Mozilla Firefox\\firefox.ext 
мербгімуег driver = new FirefoxDriver(); 





File pathToFirefoxBinary 

= new File("C:\\Program Files\\Mozilla Firefox\\firefox.exe"); 
FirefoxBinary firefoxbin = new FirefoxBinary(pathToFirefoxBinary); 
мербгіуег driver = new FirefoxDriver(firefoxbin,null); 


4... -A 
打开 ie (需要 驱动 ) 


System. ѕеЕРгорегіу( "мерагімег. іе. агімег", ".. . \\ІЕргімегбегмег.ехе' 
мербгіуег driver = пем ІпёегпеЕхр1огегргімег (); 





打开 chrome (需要 驱动 ) 


System.setProperty("webdriver.chrome.driver", ". . .\\сһготейгімег.е› 
System. ѕеЕРгорегіу ( "мебрагімег . сһпготе. ріп", 

"С: Program Еі1еѕ\\боод1Іе\\Сһготе\\Арр1ісаїіоп` 
мебргімег driver = пем Сһготергімег(); 
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打开 URL 


用 get 方 法 


driver.get("http://www.51.com"); 


或 者 用 navigate 方 法 ， 然 后 再 调用 to 方法 


driver.navigate().to("http://www.51.com"); 


关闭 浏览 器 
用 quit 方 法 


driver .quit(); 


或 者 用 close 方 法 


driver.close(); 


返回 当前 页 面 url 和 title 
得 到 title 


String title = driver.getTitle(); 


得 到 当前 页 面 url 


String currentUrl = driver.getCurrentUrl(); 


输出 title 和 currenturl 


System.out.println(title+"Yn"+currentUrl); 


其 他 方法 


е getwindowHandle() 返回 当前 的 浏览 器 的 窗口 句柄 
е getwindowHandles() 返回 当前 的 浏览 器 的 所 有 窗口 句柄 
е getPageSource() 返回 当前 页 面 的 源码 


对 浏览 器 的 支持 


HtmlUnit Driver 


т, 


优点 : HtmlUnit Driver 不 会 实际 打开 浏览 器 ， 运 行 速度 很 快 。 对 于 用 FireFox 等 浏览 
器 来 做 测试 的 自动 化 测试 用 例 ， 运 行 速度 通 常 很 慢 ，HtmlUnit Driver 无 颖 是 可 以 很 
好 地 解决 这 个 问题 。 


缺点 : 它 对 JavaScript 的 支持 不 够 好 ， 当 页 面 上 有 复杂 JavaScript 时 ， 经 常会 捕获 不 
到 页 面 元 素 。 


使 用 : 


WebDriver driver = new HtmlUnitDriver(); 


FireFox Driver 


优点 : FireFox Dirver 对 页 面 的 自 动 化 测试 支持 得 比较 好 ， 很 直观 地 模拟 页 面 的 操 
Ж», 对 JavaScript 的 支持 也 非常 完善 ， 基 本 上 页 面 上 做 的 所 有 操作 FireFox Driver 都 
可 以 模拟 。 


缺点 : 启动 很 慢 ， 运 行 也 比较 慢 ， 不 过 ， 启 动 之 后 Webdriver 的 操作 速度 虽然 不 快 
但 还 是 可 以 接受 的 ， 建 议 不 要 频繁 启 停 FireFox Driver ° 


使 用 : 


WebDriver driver = new ҒігеТохбгімег(); 


Firefox profile 的 属性 值 是 可 以 改变 的 ， 比 如 我 们 平时 使 用 得 非常 频繁 的 改变 
Useragent 的 功能 ， 可 以 这 样 修改 : 


FirefoxProfile profile = new FirefoxProfile(); 
profile.setPreference("general.useragent.override", "some UAstring' 
WebDriver driver = new FirefoxDriver(profile); 





InternetExplorer Driver 


优点 : 直观 地 模拟 用 户 的 实际 操作 ， 对 JavaScript 提 供 完 善 的 支持 。 


缺点 : 是 所 有 浏览 器 中 运行 速 漫 的 ， 并 且 只 能 在 Windows 下 运行 ， 对 CSS 以 及 
XPATH 的 支持 也 不 够 好 。 


使 用 : 


мербгіуег driver = new InternetExplorerDriver(); 


<input type="text" name="passwd" id="passwd-id" /> 


代码 : 


WebElement element = driver.findElement(By.id("passwd-id")); 


By Name 
页 面 同上 
代码 : 


WebElement е = dr.findElement(By.name("passport 51 user")); 


By XPATH 


WebElement element 
= driver.findElement(By.xpath("//input[Qid='passwd-id']")); 


By Class Name 


页 面 : 


<div class="cheese"> 
<span>Cheddar</span> 


</div> 
<divclass="cheese"> 

<span>Gouda</span> 
</div> 


代码 : 


List<WebElement> cheeses 
= driver.findElements(By.className("cheese")); 


Ву Link Text 
页 面 : 

<a href="http://www.google.com/search?q=cheese">cheese</a> 
代码 : 


WebElement cheese = driver.findElement(By.linkText("cheese")); 


控件 操作 
输入 框 


WebElement element = driver.findElement(By.id("passwd-id")); 


// 在 输入 框 中 输入 内 容 : 
element .sendKeys(“test”); 


// 将 输入 框 清空 : 
element.clear(); 


// 获 取 输 入 框 的 文本 内 容 : 
element .getText(); 


单 选 框 


WebElement radio = driver.findElement(By.id("BookMode")); 


// 选 择 某 个 单 选项 : 
radio.click(); 
// 清 空 某 个 单 选 项 : 
radio.clear(); 


// 判 断 某 个 单 选项 是 否 已 经 被 选择 : 
гайіо.155е1естеа(); 


% ИЛЕ 


WebElement checkbox = driver.findElement(By.id("myCheckbox")); 


// 与 单 选 框 类 似 
сһескрох.с1іск(); 
сһескһох.с1еаг(); 
checkbox.isSelected(); 
checkbox.isEnabled(); 


按钮 


WebElement saveButton = driver .findElement(By.id("save")); 


// 点 击 按 钮 : 
saveButton.click(); 


// 判 断 按 钮 是 否 enab1le : 
saveButton.isEnabled (); 


左右 选择 框 

也 就 是 左边 是 可 供 选择 项 ， 选 择 后 移动 到 右边 的 框 中 ， 反 之 亦 然 。 例 如 : 
Select lang = new Select(driver.findElement(By.id("languages"))); 
lang.selectByVisibleText(“English”); 


WebElement addLanguage = driver .findElement(By.id("addButton")); 
addLanguage.click(); 


т Sy 
表单 


WebElement approve = driver.findElement(By.id("approve")); 
арргоме.с11сК(); 


// 或 (只 适合 于 表单 的 提交 
approve. submit(); 


SOVE PAS 


WebElement adFileUpload = driver .findElement (By .id("WAP-upload")); 
String filePath = "C:\test\\uploadfile\\media_ads\\test.jpg"; 
adFileUpload.sendKeys(filePath); 


4 ы 


高 级 控件 
取 多 个 对 象 
findElements() 方 法 可 以 返回 一 个 符合 条 件 的 元 素 List 组 ， 例 如 : 


List<webElement> elements = driver.findElements(By.tagName("input" 
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层级 定位 
不 方便 定位 某 元 素 时 ， 可 以 先 定位 其 父 元 素 ， 再 取 父 元 素 的 子 元 素 : 


WebElement element = driver.findElements(By.className("login")); 
List<wWebElement> elements = element.findElements(By.tagName("label' 


EE 


iframe 





网 页 : 


“ 


<html> 
<head> 
<title>FrameTest</title> 
</head> 
<body style="background-color: +990000; "> 
<div id="id1">this is а div!</div> 


<iframe id="frame" frameborder="0" scrolling="no" style="left:( 


</body> 
</html> 





frame.html : 


<html> 


<head> 
<title>this is a frame!</title> 

</head> 

<body style="background-color: +009900; "> 
<div іа = "divi">this is а div › too!</div> 
<Іађе1>іприї :</1аре1> 
<input іа = "іприё1"></іприї> 

</body> 

</html> 
代码 : 


// 在 default content 定位 id="id17" 的 div 
dr .findElement(By.id("id1")); 


// 此 时 ， 没 有 进入 到 Id="frame" 的 frame 中 时 ， 以 下 两 多 会 报错 
dr.findElement(By.id("div1"));V// 报 错 
dr.findElement(By.id("input1"));// 报 错 


// 进 入 id="frame" 的 frame 中 ， 定 位 jd="div1" 的 div 和 id="input1" 的 输入 框 。 
dr.switchTo().frame("frame"); 

dr .findElement(By.id("div1")); 

dr.findElement(By.id("input1")); 


// 此 时 ， 没 有 跳出 frame， 如 果 定 位 default content 中 的 元 素 也 会 报错 。 
dr.findElement(By.id("id1"));// 报 错 


// 跳 出 frame, 进 入 default content; 重 新 定位 jd="id1" 的 div 
dr.switchTo().defaultContent(); 
dr .findElement(By.id("id1")); 


弹出 窗口 


// 得 到 当前 窗口 的 句柄 
String currentWindow = dr .getWindowHandle(); 


// 得 到 所 有 窗口 的 句柄 
Set<String> handles = dr.getwindowHandles(); 


for(String handle : handles) 


if(currentWindow.equals(handle)) continue; 
WebDriver window = dr.switchTo().window(handle); 
VER 

} 


alert ` confirm ` prompt 


getText() 得 到 它 的 文本 值 

accept() 相当 于 点 击 它 的 "确认 " 

dismiss() 相当 于 点 击 "取消 "或 者 又 掉 对 话 框 
sendKeys() 输入 值 


Alert alert = dr.switchTo().alert(); 
String text = alert.getText( ) ， 
System.out.println(text); 
alert.dismiss(); 


Alert confirm = dr.switchTo().alert(); 
String text1 = confirm.getText(); 
confirm.accept(); 


Alert prompt = dr.switchTo().alert(); 
String text2 = prompt.getText(); 
prompt.sendKeys("jarvi"); 
prompt.accept(); 


下 拉 框 


页 面 : 


<div id="car-menu"> 
<h2> 品 牌 选 择 </h2> 
<select name="cars",id="select"> 
<option value="volvo">Volvo</option> 
<option value="saab">Saab</option> 
<option value="fiat" selected="selected">Fiat</option> 
<option value="audi">Audi</option> 
<option value="bmw">BMW</option> 
<option value="Mercedes Benz ">Mercedes Benz </option> 
</select> 
</div> 


代码 : 


Select selectCar = new Select(dr.findElement(By.name("cars"))); 


// 通过 下 拉 列 表 中 选项 的 索引 选中 第 二 项 ， 
selectCar .selectByIndex(4); 


// 通过 可 见 文字 “audi” 选 中 相应 项 ， 
selectengin.selectByVisibleText("audi"); 


拖 放 元 素 


WebElement ele = dr.findElement(By.id("item1")); 
WebElement tar = dr.findElement(By.id("drop")); 
(new Action(dr)).dragAndDrop(ele, tar).perform(); 


表格 
下 面 这 个 实例 按照 原 顺序 输出 表格 中 的 内 容 : 


WebElement table = driver .findElement(By.id("my-table")); 
List<WebElement> rows = table.findElements(By.tagName("tr")); 
for (webElement row : rows) 
{ 
// 列 里 面 有 "<th>"、"<td>" 两 种 标签 ， 所 以 分 开 处 理 。 
List<webElement> heads = row.findElements(By.tagName("th")); 
for(WebElement head : heads) 
( 
System.out.print(head.getText()); 
System.out,print(" "); 


List<webElement> cols = row.findElements(By.tagName("td")); 
for(WebElement col : cols) 
{ 

System.out.print(col.getText()); 

System.out,print(" "); 


} 
System.out, ргіпё1п(); 


Cookies 


// 增加 一 个 name = "name", ма1ие="ма1ие" %соокіе 
Cookie cookie = new Cookie("name", "уаше"); 
dr.manage().addCookie(cookie); 


// 得 到 当前 页 面 下 所 有 的 cookies， 并 且 输 出 它们 的 所 在 域 、name、VvalLue、 有 效 日 期 和 
Set<Cookie> cookies = dr.manage().getCookies(); 
System.out.println(String 

.format ("Domain -> name -> value -> expiry -> path")); 
for (Cookie c : cookies) 
System.out.println(String.format("%s -> %s -> %s -> %5 -> %s", 
c.getDomain(), c.getName(), c.getValue(), c.getExpiry(),c.getPath( ` 


// 删除 cookie 有 三 种 方法 


// 第 一 种 通过 cookie 的 name 
dr.manage().deleteCookieNamed("CookieName"); 


// 第 二 种 通过 Cookie 对 象 
dr.manage().deleteCookie(cookie); 


// 第 三 种 全 部 删除 
dr .manage( ).deleteAllCookies(); 





等 待 
明确 等 待 


假设 被 测 页 面 实现 了 这 样 的 一 种 效果 : 点 击 click 按 钮 4 秒 钟 后 ， 页 
蓝 色 的 div 块 。 需要 写 一 段 自动 化 脚本 去 捕获 这 个 出 现 的 div， 然 后 高 3 


WebDriverWait wait = new WebDriverwait(dr, 10); 
wait.until(new ExpectedCondition<webElement>() 


public WebElement apply(WebDriver а) 
{ 


} 
} 


return d.findElement(By.cssSelector(",blue рох")); 


代码 WebDriverWait 类 的 构造 方法 接受 了 一 个 WebDriver 对 象 和 一 个 等 待 最 长 时 间 
(107) 。 然 后 调用 until 方 法 ， 其 中 重 写 了 nn 口中 的 apply 方 
法 ， 让 其 返回 一 个 WebElement, 即 加 载 完 成 的 元 素 。 默 认 情 况 下 ， WebDriverWait 
调用 росс аке ， 直到 有 成 功 的 返回 ， 当 然 如 果 超 过 设 定 的 
还 没有 成 功 的 返回 ， 将 抛 出 异常 


隐 性 等 待 


隐 性 等 待 是 指 当 要 查找 元 素 ， 而 这 个 元 素 没 有 马上 出 现时 ， 告 诉 WebDriver 查 询 
Dom 一 定时 间 。 默 认 值 是 0, 但 是 设置 之 后 ， 这 个 时 间 将 在 WebDriver 对 象 实例 整个 
生命 周期 都 起 作用 。 


上 面 的 代码 可 改 为 如 下 代码 : 


// 设置 10 秒 
dr.manage().timeouts().implicitlywait(10, TimeUnit.SECONDS); 


BE 


// 这 里 等 待 页 面 加 载 完 成 
Thread. sleep(5000); 


// 下 面 代码 是 得 到 截图 并 保存 在 D 盘 下 
File screenShotFile 
= ((TakesScreenshot) dr).getSscreenshotAs(OutputType.FILE); 
FileUtils.copyFile(screenShotFile, 
new File("E:/ 软 件 测试 课程 /selenium/test.png")); 


鼠标 键盘 模拟 
单一 操作 


// 新 建 一 个 action 
Actions асііоп=пем Actions(driver ) 


// 操 作 

WebElement element = dr.findElement(By.id("test")); 
WebElement element1 = dr.findElement(By.id("su")); 
action.sendKeys(element, "test").perform(); 
action.moveToElement (element1); 
action.click().perform(); 


组 合 操作 


(new Actions(dr)).dragAndDrop(dr.findElement(By.id(item)), target) 
Action dragAndDrop = builder.clickAndHold(someElement ) 
.moveToElement (otherElement) 
.release(otherElement) 
.build().perform(); 





其 他 鼠标 或 键盘 操作 方法 可 以 具体 看 一 下 API 里 面 
的 org.openga.selenium.interactions.Actions 类 。 


же 
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firefox 22. 


String PROXY = "1ocalhost:80890";// 如 果 不 是 本 机 ，1Localhost 替 换 成 ITP 地 址 
org.openqa.selenium.Proxy proxy = пем org.openqa.selenium.Proxy(); 
proxy .setHttpProxy(PROXY) 

. setFtpProxy(PROXY) 


. setSslProxy(PROXY); 
DesiredCapabilities cap = new DesiredCapabailities(); 


cap.setPreference(CapabilityType.PROXY, proxy); 
WebDriver driver = new РігеҒохргімег (сар); 


RE 二 "| 
启用 firefox 禁 用 的 功能 


FirefoxProfile profile = new FirefoxProfile(); 


profile.setEnableNativeEvents(true); 
WebDriver driver = new FirefoxDriver(profile); 


临时 指定 插件 


有 时 需要 临时 让 启动 的 firefox 带 一 个 插件 ， 如 firebug, 来 定位 问题 等 。 首 先 要 下 载 这 
个 插件 的 xpi 安 装 包 。 剩 下 的 就 让 selenium webdriver 来 完成 ， 如 下 : 


FirefoxProfile firefoxProfile = new FirefoxProfile(); 
firefoxProfile.addExtension(file); 

// 避 免 语 动画 面 
firefoxProfile.setPreference("extensions.firebug.currentVersion", ' 


WebDriver driver = new FirefoxDriver(firefoxProfile); 


EJE 





